Sesión del terminal

UiPath.Terminal.Activities.TerminalSession

Un contenedor que se conecta a un terminal y le permite realizar múltiples acciones dentro de este. Una vez que la actividad se arrastra al diseñador de flujo de trabajo, se abre la ventana Configurar conexión . Si está cerrada, se puede volver a abrir usando el botón Configurar conexión ... del cuerpo de la actividad.

Una vez configurada la conexión, el botón Iniciar grabadora se puede utilizar para conectarse al terminal y grabar las acciones necesarias. El botón se coloca en el cuerpo de la actividad.

Propiedades

Común

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

  Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad Continuar en caso de error es Verdadero, no se detectará error cuando el proyecto se ejecute.
• NombreParaMostrar: el nombre de la actividad para ser mostrado.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Nueva sesión

• Cadena de conexión : la cadena que contiene los detalles de la conexión. Este campo solo admite cadenas y variables String .
• Conexión de salida : la conexión establecida, almacenada en una variable TerminalSession . Esta variable puede pasarse a otras actividades de sesión de terminal en el campo de propiedad Conexión existente si quieres reutilizar la conexión que ya está establecida. Este campo solo admite variables TerminalSession .

Opciones

• DelayMS : tiempo de retraso (en milisegundos) antes de que la actividad comience a realizar cualquier operación. El valor predeterminado es 1000 milisegundos (1 segundo).
• TimeoutMS : especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de arrojar un error. El valor predeterminado es 50 000 milisegundos (50 segundos).

Propiedades de conexión SSH

• Contraseña SSH: la contraseña de SecureShell utilizada para conectarte al terminal especificado, almacenada en una variable SecureString . Este campo solo admite variables SecureString .
• Nombre deusuario SSH : el nombre de usuario de SecureShell utilizado para conectarse al terminal especificado, almacenado en una variable String . Este campo solo admite cadenas y variables String .

Usar conexión existente

• Cerrar conexión : si esta casilla de verificación está seleccionada, la conexión existente se cierra después de que la actividad detenga la ejecución. De forma predeterminada, esta casilla de verificación está seleccionada. Ten en cuenta que esta propiedad se ignora si se establece la propiedad Conexión de salida .
• Conexión existente : al proporcionar una variable TerminalSession en este campo de propiedad se utiliza la conexión almacenada en la variable para conectarse a un terminal. Este campo solo admite variables TerminalSession .

La ventana Configurar conexión

La ventana Configurar conexión contiene varias opciones de configuración que varían según el tipo de proveedor elegido para realizar la conexión al entorno del terminal.

Propiedades independientes del proveedor elegido:

• Mostrar aplicación cliente : si se marca, muestra una vista de la pantalla del terminal en tiempo de ejecución.

El proveedor de conexión directa

El proveedor de conexión directa es un proveedor interno de UiPath que no necesita ningún software de emulación de terminal de terceros en la máquina del robot. La emulación la realiza el robot en runtime.

Propiedades de configuración:

• Dirección : dirección IP o nombre de host del sistema del entorno del terminal.
• Puerto : un número de puerto en el que el sistema del entorno del terminal acepta conexiones.

• Tipo : el tipo de emulación de terminal necesaria:

  • TN3270 : comúnmente utilizado por los sistemas de la serie Z de IBM
  • TN5250 : comúnmente utilizado por los sistemas de la serie I de IBM (AS-400)
  • Terminales compatibles con VT - DEC VT
  • Serie HP: emulación de terminal específica de HP
  • Tandem : emulación de terminal de Tandem Systems
  • Wyse : emulación de terminal de la serie Wyse
  • ANSI : emulación de terminal basada en la especificación ANSI
  • Sco ANSI : extensión de la especificación ANSI utilizada por los sistemas SCO Unix

• Protocolo : el protocolo de comunicación que se utilizará para la conexión:

  • Telnet : el protocolo Telnet
  • SSH : el protocolo SSH utilizado por la mayoría de los sistemas Unix/Linux
  • HPVT : protocolo específico de HP utilizado junto con la emulación de terminal de la serie HP
• Modo de terminal : el tipo específico de emulación de terminal. El valor disponible aquí depende del valor elegido en el campo Tipo.
• Codificación : la página de códigos utilizada por el sistema del entorno del terminal. El valor predeterminado es IBM037 para los terminales de la familia IBM y ASCII para otros tipos de terminales.
• Habilitar SSL/TLS : se utiliza junto con el protocolo Telnet, para especificar que el sistema del entorno del terminal utiliza una conexión cifrada SSL o TLS.
• Nombre de LU : el nombre de la unidad lógica, utilizado con los tipos de terminal de la familia IBM.
• Respuesta : un mensaje de texto que se enviará al sistema host cuando el terminal reciba el carácter de control ENQ . El mensaje puede contener la clave de control Introducir, codificada en el valor de la cadena como ^M. Esta opción de configuración solo está disponible cuando el tipo de terminal seleccionado es VT.

El proveedor de IBM EHLLAPI

El proveedor IBM EHLLAPI funciona con cualquier software de emulación de terminal de terceros que implemente la API de EHLL. Los detalles para la implementación de la API de EHLL deben consultarse en la documentación del software emulador de terminal de terceros.

Nota: El software de emulación de terminal debe iniciarse y conectarse antes de intentar conectarse a él mediante EHLLAPI.

Propiedades de configuración:

• EHLL dll : la ruta a la dll utilizada para implementar EHLLAPI en el software de emulador de terminal de terceros.
• Función EHLL : el nombre de la función de punto de entrada en la dll EHLL. Normalmente, "hllapi".
• Sesión EHLL : el nombre de la sesión tal y como aparece en el software de emulación de terminal. Normalmente es "A", pero cuando se utilizan varias sesiones simultáneas, el valor puede variar.
• Codificación EHLL : la codificación utilizada por el software de emulación de terminal para la conexión dada.
• EHLL mejorado : se utiliza para especificar si el emulador de terminal de terceros implementa la versión estándar o mejorada de la API de EHLL.
• Codificación : la página de códigos utilizada por el sistema del entorno del terminal. El valor predeterminado es IBM037 para los terminales de la familia IBM y ASCII para otros tipos de terminales.
• Modo básico : un modo que deshabilita el procesamiento a nivel de campo para un mejor rendimiento. Ten en cuenta que las actividades a nivel de campo (Obtener campo, Establecer campo, etc.) no funcionarán en este modo.
• Ejecutar en proceso : controla la forma en que se realiza la comunicación con la emulación de terminal de terceros a través de la API EHLL. De forma predeterminada, está deshabilitadoy, en este caso, la comunicación se realiza a través de un proceso de proxy, un ejecutable diferente que forma parte del paquete de actividades del terminal. En tiempo de ejecución, el proceso proxy se comunicará con el proceso UiPath Executor a través de IPC (comunicación entre procesos). Cuando se habilita, la comunicación con el software de emulación de terminal de terceros se realiza dentro del proceso UiPath Executor. Esta opción solo debe habilitarse si el software antivirus o las políticas de seguridad del software impiden el correcto funcionamiento del proceso de proxy.

Nota: Debido a una limitación en la especificación de EHLLAPI, la versión mejorada de EHLLAPI no admite trabajar con varias sesiones de EHLLAPI cuando la opción Ejecutar en proceso está marcada. Solo la implementación estándar de EHLLAPI admite este escenario. Esto significa que la opción EHLL mejorada está desmarcada y el archivo DLL enumerado en el campo EHLL dll es una versión que implementa la especificación estándar EHLLAPI.

El proveedor de Attachmate Reflection

El proveedor de Attachmate Reflection funciona con el emulador de terminal de Attachmate Reflection.

Propiedades de configuración:

• Adjuntar a sesión existente : en este modo, se espera que el emulador de terminal ya esté iniciado y conectado. En este caso no se utilizará ningún perfil de configuración.
• Usar un perfil existente : en este modo, se debe proporcionar la ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

• Especificar dirección manualmente : en este modo, no se utilizará ningún perfil de configuración. Las propiedades de configuración deben especificarse manualmente:

  • Dirección: dirección IP o nombre de host del sistema del entorno del terminal
  • Puerto: un número de puerto en el que el sistema del entorno del terminal acepta conexiones

  • Tipo: el tipo de emulación de terminal necesaria:

    • TN3270
    • TN5250
    • VT

El proveedor Extra de Attachmate

¡El proveedor de Attachmate Extra funciona con Attachmate Extra! emulador de terminal.

Propiedades de configuración:

• Usar un perfil existente : se debe proporcionar una ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

El proveedor Reflection para UNIX

El proveedor Reflection para UNIX funciona con el emulador de terminal Reflection para Unix.

Propiedades de configuración:

• Usar un perfil existente : se debe proporcionar una ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

El proveedor de Reflection para IBM

El proveedor Reflection para IBM funciona con el emulador de terminal Reflection para IBM.

Propiedades de configuración:

• Usar un perfil existente : en este modo, se debe proporcionar la ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

• Especificar dirección manualmente : en este modo, no se utilizará ningún perfil de configuración. Las propiedades de configuración deben especificarse manualmente:

  • Dirección: dirección IP o nombre de host del sistema del entorno del terminal
  • Puerto: un número de puerto en el que el sistema del entorno del terminal acepta conexiones

  • Tipo: el tipo de emulación de terminal necesaria:

    • TN3270
    • TN5250
    • VT

El proveedor de Rocket BlueZone

El proveedor Rocket BlueZone funciona con el emulador de terminal Rocket BlueZone.

Propiedades de configuración:

• Usar un perfil existente : en este modo, se debe proporcionar la ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

• Especificar dirección manualmente : en este modo, no se utilizará ningún perfil de configuración. Las propiedades de configuración deben especificarse manualmente:

  • Dirección: dirección IP o nombre de host del sistema del entorno del terminal.
  • Puerto: un número de puerto en el que el sistema del entorno del terminal acepta conexiones.

  • Tipo: el tipo de emulación de terminal necesaria:

    • TN3270
    • TN5250
    • VT

El proveedor de comunicaciones personales de IBM

El proveedor de comunicaciones personales de IBM funciona con el emulador de terminal de comunicaciones personales de IBM.

Propiedades de configuración:

• Usar un perfil existente : en este modo, se debe proporcionar la ruta a un perfil de configuración. El emulador de terminal se iniciará automáticamente.

Mejores prácticas de actividades de terminal

• Al utilizar las propiedades Conexión de salida/Conexión existente , asegúrate de cerrar la sesión de terminal cuando ya no sea necesaria en el flujo de trabajo/proceso. Dejar la sesión de terminal abierta puede tener efectos negativos en el rendimiento y en la ejecución de otras sesiones de terminal. Para cerrar correctamente una sesión de terminal previamente guardada, añade una nueva sesión de terminal (con un cuerpo vacío) a tu flujo de trabajo, con las siguientes propiedades:
  • Conexión cercana: verdadero
  • Conexión existente: la variable de TerminalSession que contiene la sesión guardada
• Evite utilizar las propiedades Conexión de salida/Conexión existente junto con el proveedor IBM EHLLAPI . Estas opciones se utilizan para garantizar la persistencia de la conexión entre flujos de trabajo. Dado que la conexión ya persiste en el emulador de terminal, no se necesita una segunda capa de persistencia. Además, esto evita tener que realizar los pasos adicionales para cerrar la conexión como se describe anteriormente.
• Evita utilizar sesiones de terminal anidadas en otras sesiones de terminal. Esto también se aplica al anidamiento indirecto, como llamar desde un cuerpo de sesión de terminal a un flujo de trabajo que contiene una sesión de terminal con la misma conexión, o llamar a una función de biblioteca que contiene una sesión de terminal con la misma conexión.
• Evita utilizar actividades basadas en campos como Obtener campo/Establecer campo. No siempre está claro si la pantalla se divide en campos o cómo se divide, lo que puede generar confusión. Además, diferentes proveedores pueden dividir la misma pantalla de diferentes maneras porque se utilizan diferentes API. Es más seguro utilizar métodos similares a los que utilizarán los humanos, como combinaciones de Mover cursor o Enviar tecla de control = Tabulador seguido de las actividades Enviar teclas para enviar datos a la pantalla. Para recuperar datos de la pantalla, utiliza Obtener área de pantalla u Obtener texto en posición.
• Use la actividad Esperar texto en pantalla para asegurarse de que se cargó la pantalla correcta antes de realizar cualquier operación en ella
• Para extraer datos tabulares de pantallas en formato DataTable, use la actividad Obtener área de pantalla para la parte de la pantalla que contiene la tabla y use la salida de esta actividad como entrada para la actividad Generar tabla de datos , del paquete UiPath.System.Activities .